home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / utility / ccache11.zip / CONCACHE.TXT < prev    next >
Text File  |  1996-06-22  |  28KB  |  768 lines
  1. CONCACHE.EXE    COPYRIGHT 1995-1996 horio shoichi    CONCACHE.EXE
  2.  
  3.  
  4.  
  5. NAME
  6.      concache.exe - DOS concurrent disk cache
  7.  
  8. SYNOPSIS
  9.      concache   [memory-arguments]   [drive-arguments]   [option]
  10.      [flags]
  11.  
  12.      device=concache.exe   [memory-arguments]   [drive-arguments]
  13.      [option] [flags]
  14.  
  15.      concache VECTOR [interrupt-number interrupt-id]
  16.  
  17. COMMAND LINE RULES
  18.      Command line has following rules
  19.  
  20.      -    Operands  consist of options and terminating ';' (semi-
  21.           colon).  Except for ';' , the order is unimportant.
  22.  
  23.      -    The character ';' (semicolon) terminates command  line.
  24.           Operands after the character are ignored.
  25.  
  26.      -    All  operands are case sensitive, and generally must be
  27.           in lower case.  In this  version  VECTOR  is  the  only
  28.           upper  case  operand.  On config.sys line, operands are
  29.           converted to lower case and then interpreted.
  30.  
  31.      -    The character '/' can be placed anywhere ' ' (the white
  32.           space) can be placed.
  33.  
  34.      -    Alphabetic part of an option can be abbreviated down to
  35.           one character, if there is no ambiguities.  For example
  36.           the delete option has the syntax [d[e[l[e[t[e]]]]]].
  37.  
  38.      -    Where drives are written, the character ':' (colon) can
  39.           be written, if adjacent to drive  letter,  as  many  as
  40.           wanted.  For  example,  in  concache.exe  command line,
  41.           "sfg" is equivalent to "s:f:g:", "sf:g::", and so on.
  42.  
  43.      The   bitmap_length=   and    buffer_size=    options    and
  44.      gang_interrupts  and  gnaw_interrupt  options  are  the only
  45.      those that at least leading two letters disambiguate.
  46.  
  47. DESCRIPTION
  48.      Conc286.exe has the  same  functionality  with  concache.exe
  49.      except that it runs also on 286 based compatibles with obvi-
  50.      ous limitation it is loaded only below 640kb of main  memory
  51.      when under 286 CPU.
  52.  
  53.      The  concache.exe is the disk cache program for DOS environ-
  54.      ments. The other programs ccdisk.exe and floppies.exe  works
  55.  
  56. Concache 1.10       Last Update:  20 June 1996                  1
  57.  
  58.  
  59.  
  60. CONCACHE.EXE    COPYRIGHT 1995-1996 horio shoichi    CONCACHE.EXE
  61.  
  62.  
  63.  
  64.      under the control of this program.
  65.  
  66.      It  is  possible to load concache.exe into UMB (upper memory
  67.      block) by appropriate  load  command,  such  as  devicehigh=
  68.      instead  of  device=  or  using  loadhigh command.  Also, it
  69.      loads its resident part into UMB with its option.  This  can
  70.      be  convenient  since this method is not affected by initial
  71.      concache.exe program size.  See below for more.
  72.  
  73.      After loaded as a character device driver or as a TSR  (Ter-
  74.      minate  and  Stay Resident) program, concache.exe can change
  75.      most of parameters from command.com command line.
  76.  
  77.      If used without any operand, concache.exe lists the flags in
  78.      effect,  state  of  memory, and state of disks in use.  con-
  79.      cache.exe gets this information from  resident  concache.exe
  80.      program.
  81.  
  82.      After  concache.exe  has  become  resident,  if  windows  is
  83.      started, concache.exe is expected to be  readable  from  the
  84.      same drive and directory as it is loaded. For example, if it
  85.      is loaded from a floppy drive, the floppy  media  is  refer-
  86.      enced at the same drive when windows starts.
  87.  
  88.  
  89.   Memory Arguments
  90.      These  arguments  determines  the  cache data area and their
  91.      sizes to be used for keeping copies of disk data.  At  least
  92.      one of them must be present for concache.exe to go resident.
  93.      Each of the named memories are examined and if enough memory
  94.      is  available to satisfy the argument then they are used for
  95.      cache data area.  Memory argument takes following forms
  96.  
  97.      x[size]
  98.           Allocate/redefine  extended  memory  according  to  XMS
  99.           (Extended Memory Specification) 2.0.
  100.  
  101.      e[size]
  102.           Allocate/redefine  expanded  memory  according  to  EMS
  103.           (Expanded Memory Specification) 4.0.  Concache.exe does
  104.           not use page frames.
  105.  
  106.      p[size]
  107.           Allocate  raw  protected  memory,  retrievable via BIOS
  108.           int15.
  109.  
  110.      where size is the size to start or to continue concache.exe.
  111.      If  size  is  not  given, concache.exe uses all of available
  112.      memory of the type.
  113.  
  114.  
  115. Concache 1.10       Last Update:  20 June 1996                  2
  116.  
  117.  
  118.  
  119. CONCACHE.EXE    COPYRIGHT 1995-1996 horio shoichi    CONCACHE.EXE
  120.  
  121.  
  122.  
  123.      Int15 memory is not allowed to change its  size  after  once
  124.      concache.exe  is loaded.  Changing its size is only possible
  125.      by unloading and reloading concache.exe.
  126.  
  127.      Extended and expanded memory can  be  changed  at  any  time
  128.      after  concache.exe  is  loaded.   However, this must not be
  129.      exercised frequently, since this causes voiding  accumulated
  130.      cached data in memory.
  131.  
  132.      Size  is  written  in  decimal or in 0x preceded hexadecimal
  133.      value optionally followed by no space intervening m, mb,  k,
  134.      kb,  or  b for megabytes, kilobytes, or bytes, respectively.
  135.      (A trailing b is for "bytes".  If the  hexadecimal  is  fol-
  136.      lowed by 'b' then it is interpreted as part of value but not
  137.      to mean "bytes".)  The size is truncated to nearest multiple
  138.      of  64  kb.   If  total  usable  memory is less than 128 kb,
  139.      caching is not done.
  140.  
  141.      The total maximum value concache.exe handles is 64 mb.
  142.  
  143.  
  144.   Drive Arguments
  145.      Drive arguments define cache  refreshment  policy  for  each
  146.      drive.  They take the forms
  147.  
  148.      c[drives] (default)
  149.           to refresh cache using concurrent method, that is, con-
  150.           cache.exe refreshes unwritten (wet) cache data back  to
  151.           drives  concurrently  with  user  programs and DOS, and
  152.           possibly with the other devices,
  153.  
  154.      a[drives]
  155.           to refresh cache not using concurrent method but  using
  156.           write after,
  157.  
  158.      w[drives]
  159.           to  refresh cache with "write through" method.  This is
  160.           the safest traditional disk cache method,
  161.  
  162.      s[drives]
  163.           not to cache the data for the drives.
  164.  
  165.      Drives are written after each c, a,  w,  s  letter  with  no
  166.      spaces  and  tabs.  Range expressions of drives are allowed.
  167.      For example, wja-df-h is equivalent  to  wabcdfghj  to  mean
  168.      drives  a:, b:, c:, d:, f:, g:, h:, j: are to be cached with
  169.      write through method but drives e:, i:, and those  after  j:
  170.      are not.
  171.  
  172.      It  makes no sense to specify different refreshment policies
  173.  
  174. Concache 1.10       Last Update:  20 June 1996                  3
  175.  
  176.  
  177.  
  178. CONCACHE.EXE    COPYRIGHT 1995-1996 horio shoichi    CONCACHE.EXE
  179.  
  180.  
  181.  
  182.      for drives on the same devices. In these cases  concache.exe
  183.      uses  the most pessimistic policy for the drive.  Note actu-
  184.      ally this happens only between concurrent  and  write  after
  185.      methods.
  186.  
  187.      If  no  drives are specified after any of c, a, w, s letter,
  188.      then it means "all the other" drives.  For  example  aabc  w
  189.      specifies  drives  a:,  b:,  c:  are cached with write after
  190.      method but all the other drives are write through.
  191.  
  192.  
  193.      With similar syntax, following cache controls are available.
  194.  
  195.      r[drives]
  196.           means  refresh  unwritten  cache data back immediately.
  197.           The command awaits the completion of the writes.
  198.  
  199.      f[drives]
  200.           means discard all data for the  drive  unconditionally,
  201.           written  back  or  not.   In  practice, flush is seldom
  202.           used. If however, for example, floppy change line  does
  203.           not  work,  then cached data for the device may have to
  204.           be flushed with this method.
  205.  
  206.      n[drives]
  207.           disallows  prereading  on  the  drives.  Normally  con-
  208.           cache.exe  schedules  one  block  preread  after a read
  209.           request is completed.
  210.  
  211.      o[drives]
  212.           reenables  prereading  on  the   drives   disabled   by
  213.           n[drives].
  214.  
  215.      The  r[drives]  and f[drives] are only meaningful after con-
  216.      cache.e